home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu044.dms / pu044.adf / AmigaFox_english.doc < prev    next >
Text File  |  1991-06-21  |  23KB  |  603 lines
  1. AmigaFox
  2. --------
  3. DOCUMENTATION for version 1.10.
  4.  
  5. Author of programme.
  6.  
  7. Michael Wust
  8. Kastanienweg 2
  9. 8055 Hallbergmoos
  10.  
  11. This manual is relatively long, not (only) because, I can not express
  12. myself clearly, but you have to know, that the program has many options.
  13. Because of this, try to print this manual out, OK?
  14.  
  15. By the way, I am german, and because of this, just think about the fact,
  16. if you see any mistakes, OK?
  17.  
  18.  
  19. This manual has the following structure
  20. ---------------------------------------
  21. A.) Installation
  22.  
  23. B.) The pull-down-menus
  24.  
  25. C.) Setting up your hardware configuration
  26.  
  27. D.) The texteditor
  28.  
  29. E.) The commands for formatting
  30.  
  31. F.) The usage of external Charsets
  32.  
  33. G.) The graphicseditor
  34.  
  35. H.) The print-out
  36.  
  37. I.) Some sentences about copyright
  38.  
  39. J.) The authors final sentences
  40.  
  41.  
  42. ----------------------------------------------------------------------
  43.  
  44. A.) INSTALLATION
  45. ----------------
  46.  
  47. If you have a harddisc...
  48. -------------------------
  49. ...then you have to copy the file "AmigaFox" (the program itself) some-
  50. where onto your harddisc, just remember, that you must find it. You
  51. need the drawer "AfoxSys" in the root-directory. This drawer contains
  52.  a.) the file "ConfigSys" (greetings from MS-DOS) and
  53.  b.) the subdrawer "Drucker" (german, means printer in english). Here
  54.      AmigaFox looks for any printroutines. You have to know, that
  55.      AmigaFox can not make use of the AmigaDOS-printer-routines
  56.      from SYS:DEVS/PRINTERS/, because they are too low resoluted.
  57.      Through this, can´t mix up the printer-routines for AmigaDOS
  58.      and for AmigaFox.
  59. You also need the following files:
  60. "parallel.device"   in SYS:DEVS/
  61. "printer.device"    in SYS:DEVS/
  62. "diskfont.library"  in SYS:LIBS/
  63. "Port-Handler"      in SYS:L/
  64. If you can not boot from your Harddisc, then you have to "Assign" all
  65. system-directories from df0: to dh0: or leave your boot-disc in df0:
  66. and start AmigaFox after giving the CLI-command "cd dh0:".
  67.  
  68. If you work with floppy discs...
  69. --------------------------------
  70. ...then you just do it the way, you would do, if you had a bootable
  71. harddisc.
  72.  
  73. How can you start AmigaFox?
  74. ---------------------------
  75. You can start it from CLI or by making a doubleclick on the tool-type-
  76. icon from AmigaFox
  77.  
  78. How many memory do I need?
  79. --------------------------
  80. AmigaFox runs theoretically on a 256 KB RAM-machine. You will see very
  81. soon, that you can not even make use of more than 512 KB RAM. Unlike
  82. version1.00 & V1.01, 512KB. makes things much easier because a store
  83. is used in the GFX-Editor for copying an area.
  84.  
  85. Does AmigaFox accept multitasking?
  86. ----------------------------------
  87. Yes, but other tasks will be slowed down, because AmigaFox needs some
  88. time for math operations.
  89.  
  90. Which expansions does AmigaFox not like?
  91. ----------------------------------------
  92. If you want to use proportional charsets, than you need to know, that
  93. you have not to use FastFonts (from the Workbench 1.3). Otherwise
  94. those charsets will not be accepted.  
  95. ----------------------------------------------------------------------
  96.  
  97.  
  98. B.) THE PULL-DOWN-MENUS
  99. -----------------------
  100.  
  101. 1.) Project
  102. -----------
  103. Here you can do everything to control or set up the program.
  104.  
  105. 2.) Texteditor
  106. --------------
  107. Here you can do everything to handle with texts.
  108.  
  109. 3.) Graphicseditor
  110. ------------------
  111. Here you can do everything to handle with the graphics, which
  112. is build up from the text by converting it.
  113.  
  114. 4.) Charsets
  115. ------------
  116. Here you can do everything, which has to do something with the
  117. external charsets.
  118.  
  119.  
  120. PROJECT - Texteditor
  121. --------------------
  122. Jumps into the texteditor. Can be used as a refresh for the texteditor,
  123. if errors appear.
  124.  
  125. PROJECT - Graphicseditor
  126. ------------------------
  127. Jumps into the graphicseditor. Here you can draw and print out your
  128. graphics.
  129.  
  130. PROJECT - Converting
  131. --------------------
  132. The text in the texteditor will be converted into a graphics, which
  133. can be printed out. After converting the program jumps into the
  134. graphicseditor. While converting the program looks for commands
  135. for formatting, charsets and splits the text up into the pages.
  136.  
  137. PROJECT - printer set up
  138. ------------------------
  139. Here you can set up your printer. AmigaFox makes no use of
  140. the AmigaDOS-printer-routines, because they are not highly
  141. resoluted enough. You have to enter the ESC-sequences of
  142. your printer.                                          
  143.  
  144.  If you have problems with setting up your printer, then send me
  145. a copy of your printer-manual (just the page with the summary of
  146. the printer-commands) and a empty disk and I will send you the
  147. printer-routine for your printer, which has to be copied in the
  148. drawer AFoxSys/Drucker.
  149.  
  150. PROJECT - Save preferences
  151. --------------------------
  152. Here can save your current settings such as:
  153.  a.) the path for the charsets
  154.  b.) the printer
  155.  c.) the amount of text memory
  156. If you then start AmigaFox next time, your settings will be auto-
  157. matically made.
  158.  
  159. PROJECT - End
  160. -------------
  161. After asking you, if you are sure to end the program, it will be ended.
  162.  
  163. TEXTEDITOR - load texts
  164. -----------------------
  165. If you select this one, then there will appear an Requester with the
  166. following Gadgets:
  167. DF0:    load directory from df0:
  168. DF1:    load directory from df1:
  169. DH0:    load directory from dh0:
  170. LIST    brings the directory on the screen
  171. PARENT  brings the parent directory on the screen
  172. CANCEL  goes back without loading any text
  173. LOAD    goes back by loading the selected text
  174. The four images below let the directory scroll up and down.
  175. By the way, you can also load texts, that fit into the text memory!
  176.  
  177. TEXTEDITOR - save texts
  178. -----------------------
  179. The text will be saved. If there exists a text with the same name,
  180. you will be asked, if it shall be overwritten.
  181.  
  182. TEXTEDITOR - save texts as
  183. --------------------------
  184. just as above, but before saving, you will be asked for a file name
  185.  
  186. TEXTEDITOR - clear text
  187. -----------------------
  188. If you really want it (AmigaFox asks you), then you can clear the
  189. text in the memory.
  190.  
  191. TEXTEDITOR - Find
  192. -----------------
  193. You can enter strings, which have to be found and showed in the text.
  194. You can also enter a string, which will be entered in the text for
  195. the find-text.
  196.  
  197. TEXTEDITOR - Next
  198. -----------------
  199. The search goes forward after the find-text
  200.  
  201. TEXTEDITOR - Previous
  202. ---------------------
  203. The search goes backwards after the find-text
  204.  
  205. TEXTEDITOR - Replace
  206. --------------------
  207. The search-text will be entered for the find-text.
  208.  
  209. TEXTEDITOR - Helping page
  210. -------------------------
  211. A helping page will appear, on which you can reread all the keyboard
  212. commands for the texteditor.
  213.  
  214. TEXTEDITOR - Change text memory
  215. -------------------------------
  216. Here the amount of memory for the text can be changed. You have to
  217. enter a decimal-number between 500 and 65535 (minmum and maximum) and
  218. select change, if you want to save the whole by PROJECT-save preferences.
  219. If there is not enough text memory, you have to enter new numbers till
  220. there is enough memory for your amount.
  221.                                                         
  222. GRAPHICSEDITOR - load IFF-picture
  223. ---------------------------------
  224. You can load pictures in the common IFF-ILBM-standard. The special-
  225. chunk-formats of the common programs can be loaded, because AmigaFox
  226. only uses the chunks BMHD and BODY.
  227.  
  228. AmigaFox accepts compressed and uncompressed pictures.
  229.  
  230. In spite of the fact, that AmigaFox works in the b/w-mode, the colors
  231. of 4 bitplanes can be converted into shadings. For the last two
  232. possible bitplanes I hade no more ideas. Just write me,
  233. if you have one,OK?
  234.  
  235. The picture will always be loaded from (0;0). (latest picture only with
  236. maximum size 640 X 256 ). When loaded a small box appears place it where
  237. you want the picture to be and click once with the left mouse button.
  238. (Take note of your margins).
  239.                                                         
  240. GRAPHICSEDITOR - save IFF-picture
  241. ---------------------------------
  242. Here you can save the current (!) screen or the whole bitmap as a
  243. IFF-ILBM-picture, compressed or uncompressed, just what you like or
  244. need. You will be asked, if there´s already a file with the same name.
  245.  
  246. If you save the whole bitmap, then Deluxe Paint III will load it as
  247. Interlace-graphics. The remaining 100 Bytes (PAL-resolution,
  248. NTSC: 220 Bytes) then can be scrolled by the cursor keys.
  249.  
  250. But I recognized, that DPaint III is not willing to load some of the
  251. pictures. This is the case, if there is a horizontal line in the
  252. first bitmap line. But don´t panic! It´s only DPaint III, that makes
  253. the troubles, just because of the super-special-chucks such as
  254. DPPS, DPPV. (To Dan Silva: Stop it! Please use the ´normal´ Chunks!)
  255. AmigaFox always loads those IFF-pictures!
  256. A small hint:
  257. Try to save pictures uncompressed, if DPaint makes trouble.
  258.  
  259. GRAPHICSEDITOR - clear picture
  260. ------------------------------
  261. Here you can clear the bitmap or the current screen. Don´t panic!
  262. You will be aksed, if you are sure, before the command will be
  263. executed.
  264.  
  265. GRAPHICSEDITOR - print out
  266. --------------------------
  267. The graphics will be printed out via the "PAR:"-device. You can
  268. read more about in sector H.)
  269.  
  270. GRAPHICSEDITOR - helping page
  271. -----------------------------
  272. There will appear a list of the keyboard commands.
  273.  
  274. CAHRSETS - load CS from Disk
  275. ----------------------------
  276. One by one all charsets AmigaFox can find the given path will be
  277. displayed. AmigaFox only accepts AmigaDOS-format. Ensuing these
  278. charsets can be brought to the screen or loaded into memory. For this
  279. you firstly click the option (Show CS or load CS) and then the
  280. charsets name. You can also change the disk and leave the requester.
  281.  
  282. A small hint: Create yourself a disk, on which there are only charsets.
  283. Optimize this disk with the help of XCopy II and then you have a disk,
  284. with which you can reach a speed, which is ok. Otherwise you sit up
  285. to two minutes in front of your screen, while AmigaFox loads 110 char-
  286. sets. Bur don´t panic! For the time AmigaFox is in memory, this
  287. operation only needs to be done one time.
  288.  
  289. CHARSETS - Show CS in RAM
  290. -------------------------
  291. The charsets, which have been loaded into ram, will be displayed. They
  292. even will be numbered. You can select the following options just like
  293. the way before described:
  294.  "Show CS"        display charset, just to look on it
  295.  "Use CS"         Creates a formatline at the current cursorposition.
  296.                   While converting the selected charset will be
  297.                   activated. This makes the use of external
  298.                   charsets very easy!
  299.  "Clear CS"       not activated!
  300.  
  301. CHARSETS - clear charsets
  302. -------------------------
  303. if you are sure (you will be asked before), the charsets, which have
  304. been loaded into RAM, will be cleared. This is necessary, because
  305. there are only 60 charsets in RAM possible.
  306.  
  307. CHARSETS - enter path for CS
  308. ----------------------------
  309. Here the path for the charsets can be changed! It will be saved at
  310. PROJECT - Save preferences. possible exemples:
  311. "df0:fonts"
  312. "df1:fonts"
  313. "dh0:fonts"
  314.  
  315.  
  316. --------------------------------------------------------------------------
  317.  
  318.  
  319. C.) SETTING UP YOUR HARDWARE CONFIGURATION
  320. ------------------------------------------
  321.  
  322. After installing AmigaFox to your Disk or Harddisc, start it.
  323. Now click the menu >TEXTEDITOR - Change text memory< and enter
  324. the amount of text memory you wish to have in decimal numbers.
  325. Then click >change< to execute the changing.
  326.  
  327. Now go to >CHARSET - enter path for CS< and tell AmigaFox, where
  328. it can find your charsets.
  329.                                                    
  330. At the end you now install your printer from your menu:
  331. Click >PROJECT - PRINTER INSTALL.
  332.  
  333. On this disk you find the printer-routine >Epson-kompatibel<, which
  334. should work with most of the printers.
  335.  
  336. Now save all these settings with >PROJECT - Save preferences< and you
  337. are ready.
  338.  
  339.  
  340. ------------------------------------------------------------------------
  341.  
  342.  
  343. D.) TEXTEDITOR
  344. --------------
  345.  
  346. Keyboard commands of the texteditor:
  347.  
  348. CTRL + Y      Clear this line
  349. PgUp          One page backwards
  350. PgDn          One page forward
  351. Home          To the beginning of the text
  352. End           To the end of the text
  353. F1            Mark the beginning of the block
  354. F2            Mark the end of the block
  355. F3            Clear that block
  356. F4            Copy that block to the actual cursorposition
  357. F5            Clear the definition of the block
  358.  
  359. All keyboard keys like the cursor keys, the Delete key, the Backspace
  360. key, the return key and all the other keys, that make the entering
  361. of text possible, are active.
  362. AmigaFox does not make use of the actual keyboard map, selected via
  363. Setmap from CLI. Because of this the german version always has the
  364. correct keyboard map. The several versions of AmigaFox V1.0 are:
  365.  
  366. Country       TV mode       Name                     SetMap-keymap
  367. ----------    -------       ---------------------    --------------
  368. Germany       PAL           AmigaFox PAL V1.00 d     german (d)
  369. USA           NTSC          AmigaFox NTSC V1.00 e    american (usa0)
  370. England +
  371. Rest of World PAL           AmigaFox PAL V1.00 e     american (usa0)
  372. Germany       PAL           AmigaFox PAL V1.01 d     german (d)
  373. Germany       PAL           AmigaFox1.10             german (d)
  374. UK            PAL           AmigaFox1.10 english     german (d)
  375.                            (Computereyes version)
  376. -----------------------------------------------------------------------
  377.  
  378.  
  379. E.) THE COMMANDS FOR FORMATTING
  380. -------------------------------
  381.  
  382. There are several format commands. With the help of these commands
  383. the user can select bold or italic
  384.  
  385. CTRL + f    (an invers f will appear)
  386.             FORMATLINE. This is the most important command. The content
  387.             of the formatline will not be converted, but will change
  388.             the settings of the following variables:
  389.             X = ...    Distance from the left border for the text
  390.             Y = ...    Distance from the upper border for the text
  391.             L = ...    Length of the line in bytes
  392.             I = ...    Tabulator (Sorry, only one)
  393.             V = ...    Distance between the lines
  394.             H = ...    Distance between the letters
  395.             S = ...    Mode of formatting
  396.                        S = 0  : on the left border
  397.                        S = 1  : block-printing
  398.                        S = 2  : centered
  399.                        S = 3  : on the right border
  400.             Z = ...    Here you can select charsets for formatting
  401.                        We will discuss this in sector F.)
  402.             Who ever had a C64. already recognizes, that AmigaFox
  403.             is widely similar to Printfox
  404.                       ----------------------
  405.             Example for a formatline:
  406.             <CTRL-f>x=0 y=0 l=420 s=1 v=2 h=1<Return>
  407.                      (ideal Setup for a DIN A5-print out)
  408.             The presettings are for a print-out of a letter.
  409. CTRL + e    (an invers e will appear)
  410.             Till the next CTRL + e the text will be printed bold.
  411. CTRL + k    (an invers k will appear)
  412.             (This command does not exist at Printfox)
  413.             Till the next CTRL + k the text will be printed italic
  414. CTRL + u    (an invers u will appear)
  415.             Till the next CTRL + u the text will be printed underlined
  416. CTRL + i    (an invers i will appear)
  417.             Jumps to the tabulator-mark. Will be the left margin till
  418.             next return.
  419. CTRL + c    (an invers c will appear)
  420.             This line will be printed centered
  421. CTRL+CrsrRt (an inverse right arrow  will appear)
  422.             This line will be printed concisely to the right            
  423. CTRL+CrsrLt (an inverse left arrow will appear)
  424.             This line will be printed consisely to the left
  425. CTRL + p    (an sign showing up and down will appear)
  426.             Here stops one page and begins another. The selection
  427.             of the page to be converted is made at the beginning
  428.             of converting. There are 30 pages possible.
  429. CTRL+CrsrUp (an inverse up arrow will appear)
  430.             Superscript on.
  431. CTRL+CrsrDn (an inverse down arrow will appear)
  432.             Superscript on.
  433.  
  434. -----------------------------------------------------------------------
  435.  
  436.  
  437. F.) THE USAGE OF EXTERNAL CHARSETS
  438. ----------------------------------
  439. AmigaFox is able to use the common AmigaDOS-Format for charsets.
  440. Because of this, the user can use a great number of charsets. As well
  441. as on PD-series-disks and commercial productions you can find several
  442. charsets for your AmigaFox.
  443.  
  444. For the beginning you have to be satisfied with the topaz.font, the fonts
  445. from your Workbench and the printfox.font (Height 9) on this disk.
  446.  
  447. Work this way and it is very easy for you:
  448. 1.) Write your text
  449. 2.) Move your Cursor to that position, where you want to change the
  450.     charset.
  451. 3.) click "load CS from Disk"
  452. 4.) After AmigaFox finished his work and has all charsets on the
  453.     screen (the zzz-symbol vanishes), click the option "Show CS"
  454.     and look at each charset till you found, what you have been
  455.     looking for.
  456. 5.) Click the option "Use CS" and then click the charset one time.
  457.     Don´t get worried by the fact, that nothing happens!
  458. 6.) Leave the requester and move to next position where you want to
  459.     change the charset. Then continue with 3.)
  460.  
  461. At 5.) a new formatline will be inserted into your text:
  462. >CTRL-f< Z = "charsetname.font",Height >Return<
  463. (Example: >CTRL-f< Z = "printfox.font",9 >Return<
  464.  
  465. While converting the charset will be loaded into RAM. So each
  466. charset has to be loaded only once till it will be cleared.
  467. Of course the following text will appear in the letters of the
  468. charset.
  469.  
  470. You can also write the formatline yourself, but this way it is
  471. much easier. At a time, when you are a professional AmigaFoxer,
  472. you will write them yourself.
  473.  
  474.  
  475. ----------------------------------------------------------------------
  476.  
  477.  
  478. G.) GRAPHICSEDITOR
  479. ------------------
  480.  
  481. In the graphicseditor you can manipulate your picture, which has been
  482. build up out of your text and format commands. In the graphicseditor
  483. there are several keyboard commands possible:
  484.  
  485. CrsrDn  With this key you can scroll through the Bitmap (640 x 800
  486.         dots) down to the end.
  487. CrsrUp  like CrsrDn, but the other way
  488. PgDn    Fast scrolling down
  489. PgUp    Fast scrolling up
  490. d       By pressing the left Mousebutton a dot will be set. While
  491.         pressing and moving the mouse many dots will be set.
  492. z       like d, but the dots will be connected
  493. l       Here you can draw lines. Move to the starting point of your
  494.         line, press the left mousebutton, move to the ending point
  495.         of your line, release the button and...ready!
  496. r       Drawing rectangles, functiones like l
  497. p       Flooding. Move the area to be filled and press mouse.
  498. 1-9     several patterns for the flooding. try 7-9!
  499. k       Set the GFX co-ordinates and style.
  500. i       Inverting the actual screen
  501. I       Inverting the whole bitmap (no UNDo possible!)
  502. w       Overview. The Bitmap of 640 x 800 dots will be split up into
  503.         two times 640 x 400, which are reduced to 320 x 200.
  504.         If you forget to press F10 (=UNDO) after looking at the
  505.         overview, the Bitmap will be destroyed.
  506. c       Define block to copy. Mark start of blocks to copy, press left
  507.         mouse  & with button pressed move to the end & release button.
  508.         AmigaFox now goes automatically into mode. Now C will start.
  509. C       Copy block in Picture memory. When the frame appears click
  510.         left mouse to copy picture to block.
  511. F10     UNDO-function. Makes the last action undone.
  512.  
  513.                      
  514. ----------------------------------------------------------------------
  515.  
  516.  
  517. H.) THE PRINT-OUT
  518. -----------------
  519. After clicking GRAPHICSEDITOR - print out the parallel.device will be
  520. loaded into RAM, where it is kept until the end of AmigaFox.
  521. AmigaFox asks you, if the print-out shall be in normal- or high
  522. quality.
  523.  
  524. AmigaFox always lets you know how far the print-out is. So you never
  525. have to stand up and look after your printer. Just look on the
  526. screen. The colored block shows you, where the printer is so far.
  527.  
  528. The print-out can be stopped by pressing the left mousbutton.
  529. After printing the current line to its end, you will be asked, if
  530. you are sure to end the print-out.
  531.  
  532.  
  533. ---------------------------------------------------------------------
  534.  
  535.  
  536. I.) SOME SENTENCES ABOUT COPYRIGHT
  537. ----------------------------------
  538.  
  539. AmigaFox V1.10 is a PUBLIC-DOMAIN-FREEWARE-PROGRAM
  540. =================================================
  541. this means, that everyone has to have the chance to get this program.
  542.  
  543. Someone is allowed to get his expenses back, he has for giving the
  544. program to someone else, but it is not allowed to make profit!!!
  545.  
  546. If someone wants to release AmigaFox in a super-special-version with
  547. a printed manual, then he has to have my written assent.
  548.  
  549. To Mr.Ossowski (german PD-dealer)
  550. ---------------------------------
  551. Mr.Ossowski does not get this assent. He only is allowed to release
  552. AmigaFox on his TAIFUN series-disk.
  553.  
  554. To the people of Markt & Technik (german publishing house for comp.magaz.)
  555. --------------------------------------------------------------------------
  556. If you decide to test PD-programes objectively in future, then you are
  557. allowed to test AmigaFox too. If not, then not.
  558.              
  559. ------------------------------------------------------------------------
  560.  
  561.  
  562. J.) THE AUTHORS LAST SENTENCES
  563. ------------------------------
  564.  
  565. To the users of AmigaFox, that want to make me happy:
  566. -----------------------------------------------------
  567. Please send me your printer-routines, your charsets and your graphics,
  568. but everything has to be designed or created by yourself.
  569. For that, I send you a nice letter and the latest version
  570. of AmigaFox, which I will copy on your disk with the printer-routines,
  571. charsets and graphics (3,5" and 5,25" possible).
  572. I also would be very happy, if you sent me a greeting card from
  573. your home town, so that I can see, where me users are living.
  574.  
  575. AmigaFox´s History
  576. ------------------
  577. AmigaFox has been written to 100% in Assembler. I took the HiSoft-
  578. DevPac-Assembler. The sourcecode has over 200 KByte and exactly
  579. 10038 lines. What a length! By the way, I will not give away the
  580. sourcecode of AmigaFox!
  581.  
  582. The programming of AmigaFox V1.10 took nearly a half year. Firstly, I
  583. programmed AmigaFox for myself, because I found DOCUMENTUM not
  584. that good. What I wanted is Printfox on the Amiga and I think,
  585. it´s a nice program I made. But it will spend much time to make
  586. AmigaFox to that program, I think it should be.
  587.                                 
  588. Next will be the programming for Moving and Making graphics bigger
  589. and smaller, a Circle- and Ellipse-routine and and and...
  590.  
  591. Now, I wish you the greatest fun on earth with AmigaFox. If you find
  592. a bug, then tell me! PLEASE!
  593.  
  594. Here is my adress (only written contact, I am never at home!):
  595.  
  596.                            Michael Wüst
  597.                           Kastanienweg 2
  598.                       BRD-8055 Hallbergmoos
  599.                            WEST GERMANY
  600.  
  601. BYE, BYE, BYE, BYE, BYE, BYE, BYE, BYE, BYE, BYE, BYE, BYE, BYE, BYE, BYE
  602.  
  603.